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INTRQQWCTION 

The io_cal I command currently provides complete facilities 
at command level for performing all possible operations on a 
single I/O switch, with the exception of lox_tcontrol requiring 
an information pointer. As such* it provides an extremely useful 
tool for setting up user program input/output switches, and for 
debugging programs and I/O modules. 

The ma|or facility it does not provide Is a copy facility. 
There is a need to copy from one switch to another, either until 
the input switch exhausts the input source, or until a certain 
number of read/write operations have been performed. 

A switch-to-switch copy facility would support file-to-tape 
operations through any of the tape I/O modules, file-to-disk 
operations through the disk I/O module, and special-purpose 
file-to-printer, card reader-to-file, and file-to-card punch 
operations. As such, it would be a useful tool for debugging, 
and for quick copy operations between various media. 

INTERFACE 

See the attached draft MPM documentation. 

CRITICISM 

The above interface can copy from or to any type of fife 
except for keyed sequential files. One can argue that ttiese are 
only supported by the storage system (vfile_) currently, and can 
be copied with the copy command. 

An alternate proposal would use a -keyed control argument to 
signify that both the input and output files were Keyed 
sequential. The input file would be opened for 
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keyed_sequential_lnput and the output file for 

keyed_sequentlal_output. Records and their keys could then be 

read with read — key/read_record operations* and written with 
seek_key/wrlte_record operations. 

Given the United use of keyed files and the availability of 
the copy command* it is probably unnecessary for f 1 le_copy to 
provide this level of support* Note that the Interface docs 
permit a keyed sequential input file to be read and copied in a 
sequential manner. 

While the Interface can copy unstructured files* the 
record_stream_ I/O module is required as an intermediary. 
Although the transformation function could conceivably be 
Integrated with file_copy* the record_stream_ I/O module was 
specifically designed to effect this type of conversion* and 
there is no need to duplicate Its function within the flle_copy 
command. 
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Haa^s* fite_copy, fc 

This coamand copies records from an Input file to an output 
file. The Input and output file types Bust be sequential. (See 
Unstructured Files and Keyed Files, below, for an explanation of 
ho* these types of files may be copied.) The input file nay be 
copied either partially, or in its entirety. 

flle_copy input__spec output,. spec -control_args- 
wherei 

1. input_spec specifies the input file froe which records 

are read. It nay be either an I/O switch 
naae, or an attach description. (See Notes, 
below.) 

-input_switch switchname 

-isw switchname 

specifies the input file by means of an 
already attached I/O switch name, switchname. 

-input.fi le XXX 

* lf xxx specifies the input file by aeans of an 
attach description, XXX. 

2. output_spec specifies the output file to which these 

records are written. It nay be either an I/O 
switch naae, or an attach description. (See 
Notes, below.) 

-out put_sw Itch switchname 

-osw SMitchnaae 

specifies the output file by means of an 
already attached I/O switch naae, swltchnaae. 

-output_file XXX 

-of XXX specifies the output file by means of an 
attach description, XXX. 

3. control_args may be one or aore of the following optional 

control arguments (see Notes, below) I 

-froe I 

*•'■ I specifies that records are copied beginning 
with the Ith record of the Input file. I 
must be a positive integer. The default is 
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-to J 



•count N 
•ct N 



to begin copying Mlth the 
(See Notest below.) 



"next record' 



specifies that copying is performed until the 
Jth record has been copied* or the Input file 
exhausted* whichever occurs first. If this 
option is specified* -from aust also be 
specified* J aust be a positive integer* 
greater than or equal to I. 



specifies that copying is performed until N 
records have been copied* or the input file 
exhausted* whichever occurs first- N aust be 
a positive integer. 



-all* -a 



specifies that records are copied until the 
Input file is exhausted. This Is the 
default. 



-brief, -bf 



specifies that the message 
number of records actually 
suppressed. 



indicating the 
copied is to be 



-long, -Ig 



specifies that a message Indicating the 
number of records actual ly copied is to be 
printed. This Is the default. 



Unstructured Ellas 

flle_copy operates by performing record I/O on structured 
files. If It is desired to copy from/to an unstructured file* 
the record_stream_ I/O module may used* e*g.t 



file_copy -If record_stream_ -target vfile_ pathname -osw 



OUT 



The effect is to take lines from the file specified by pathname 
yla vfile_» transform them into records JtXa record_stream_ * and 
then copy them to the I/O switch named OUT. 



Keyed Files 

flle_copy processes only the sequential type of structured 
file. The copy command may be used to copy Indexed sequential 
storage system files preserving keys. (See the MPM write-up of 
the copy command.) However* file.copy may be used to copy an 
Indexed sequential input file in a sequential manner 
(disregarding keys). Note that the output file type is 
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sequential* not indexed sequential. 
Notes 

If either the input or output specification is an attach 

description* it is used to attach an unique I y-named I/O switch to 

the file. The snitch is opened for sequential_input or 

sequential_output, the copy per forded, and then closed and 
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arguments used by file_copy, then it must be quoted. 
Alternately, an I/O snitch nay be attached using the io call 
command, and the file specified by aeens of the I/O switch naie. 
(See the HPH write-up of the io_call command.) 

If the input file is specified by an I/O switch name and the 
switch is not open* file_copy opens it for sequential input* 
performs the copy, and closes it. If the switch Is already open 
when file.copy is invoked* It Is not closed after the copy has 
been performed; the file is left positioned immediately after 
the last record copied. 

If the -from control argument is not used to specify an 
absolute starting position within the input file, copying begins 
with the "next record". If the I/O switch is opened by 
flle_copy, the next record is the first record of the file; 
otherwise, the next record Is that record at which the file is 
positioned when file_copy is invoked. 

If the output file Is specified by an I/O switch name and 
the switch is not open, file_copy opens it for sequential output, 
performs the copy, and closes it. If the switch is already open 
when file_copy is Invoked, it is not closed after the copy has 
been performed! the file is left positioned immediately after 
the last record copied. 

The -brief and -long control arguments are mutually 
exclusive. The copy count message appears as follows* 

file_copyi 3<»5 records copied. (EOI) 

The appearance of EOI (End flf Information) Indicates that the 
last record copied was the last record in the input file. 

The -to, -count, and -alt control arguments are mutually 
exclusive. 
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